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PREFACE 


This  unit  test  plan  covers  the  work  performed  under  Air 
Force  Contract  F33615-80-C-5155  ( ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory.  Air  Force 
Systems  Command,  Wr ight-Patterson  Air  Force  Base.  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C 
Shumaker.  ICAM  Program  Manager.  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company.  Schenectady.  New  York,  under  the  direction  of 
Mr  Alan  Rubenstein  The  General  Electric  Project  Manager  war 
Mr  Myron  Hurlbut  of  Industrial  Automation  Systems  Department 
Albany.  New  York 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473)  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 .  Project  Overview 

The  subcontractors  and  their  contribu  ting  activities  were 
as  foil ows 


TASK  4  2 

Subcontractors  Role 


Boeing  Military  Aircraft 
Company  ( BMAC ) 

D  Appleton  Company 
( DACOM ) 


General  Dynamics 
Ft  Worth 


Rev i ewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
mode  1  s 
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Role 


Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pntsker  and  Associates 
Sof Tech 

TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  ( BMAC ) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 

(  CDC  ) 

D.  Appleton  Company 
( DACOM ) 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-size  business. 


Responsible  for  factory  view 
function  and  information 
mode  1 s . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


Responsible  for  consultation  on 
appl  i cat  ions  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  ( CDM )  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM) . 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


Rev i ewer . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  8  Dodge) 


SofTech,  Inc. 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
( SDRC ) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701,  2201,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC)  . 
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Contractors 

ICAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502.  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Company 
( DACOM ) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  ( HAC ) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
( SDRC ) 

1502,  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI) . 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTION  1 
GENERAL 


1 . 1  Purpose 

This  unit  test  plan  establishes  the  methodology  and 
procedures  used  to  adequately  test  the  capabilities  of  the 
computer  programs  identified  as  the  Forms  Definition  Language 
Compiler  known  in  this  document  as  FLAN,  the  Reverse  FLAN 
Compiler  known  as  REVFLAN .  and  Make  Includes  known  as  MAKINC. 
FLAN,  REVFLAN  and  MAKINC  are  configuration  items  of  the 
Integrated  Information  Support  System  (IISS)  User  Interface 
(UI). 

1 . 2  Project  References 

[1]  ICAM  Documentation  Standards ,  15  September  1983, 
IDS150120000C. 

[2]  IISS  Integration  Task  Force,  Final  Report ,  1984. 

[3]  General  Electric  Company,  System  Design  Specification , 
7  February  1983. 

[4]  Structural  Dynamics  Research  Corporation,  Forms 
Language  Compi ler  Development  Specification,  DS 
620144401B,  1  November  1985. 

[5]  Structural  Dynamics  Research  Corporation,  Forms  Driven 
Form  Edi tor  Unit  Test  Plan ,  UTP620144402  .  1  November 
1985  . 

[6]  Structural  Dynamics  Research  Corporation,  Report 
Writer  Unit  Test  Plan.  UTP620144501  ,  1  November  1985. 

[7]  Structural  Dynamics  Research  Corporation,  Rapid 

Appl i cat  ion  Generator  Unit  Test  Plan  ,  UTP620144502 ,  1 

November  1985. 

[8]  Structural  Dynamics  Research  Corporation,  Text  Editor 
Unit  Test  Plan,  UTP620144600  .  1  November  1985. 

[9]  Structural  Dynamics  Research  Corporation.  Appl i cat  ion 
Interface  Unit  Test  Plan ,  UTP620144700  ,  1  November 
1985. 
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[ 10]  Structural  Dynamics  Research  Corporation,  User 
Interface  Services  Unit  Test  Plan ,  UTP620144100 ,  1 
November  1985. 

[11]  Structural  Dynamics  Research  Corporation,  Form 
Processor  Unit  Test  Plan ,  UTP620144200  ,  1  November 
1985  . 

[12]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Interface  Unit  Test  Plan .  UTP620144300 ,  1 
November  1985 . 

[13]  Systran,  I CAM  Documentation  Standards ,  15  September 
1983. 

1.3  Terms  and  Abbreviations 


Appl i cat  ion  Definition  Language :  an  extension  of  the  Forms 
Definition  Language  that  includes  retrieval  of  database 
information  and  conditional  actions.  It  is  used  to  define 
interactive  application  programs. 

Attribute :  field  characteristic  such  as  blinking, 
highlighted,  black,  etc.  and  various  other  combinations. 
Background  attributes  are  defined  for  forms  or  windows  only. 
Foreground  attributes  are  defined  for  items.  Attributes  may  be 
permanent,  i.e.,  they  remain  the  same  unless  changed  by  the 
application  program,  or  they  may  be  temporary,  i.e.,  they  remain 
in  effect  until  the  window  is  redisplayed. 

Common  Data  Model :  (CDM),  IISS  subsystem  that  describes 
common  data  application  process  formats,  form  definitions,  etc. 
of  the  IISS  and  includes  conceptual  schema,  external  schemas, 
internal  schemas,  and  schema  transformation  operators. 

Display  Li st :  is  similar  to  the  open  list,  except  that  it 
contains  only  those  forms  that  have  been  added  to  the  screen  and 
are  currently  displayed  on  the  screen. 

Field :  two-dimensional  space  on  a  terminal  screen. 

Form:  structured  view  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields.  These  fields  may  be 
defined  as  forms,  items,  and  windows. 

Form  Def ini t ion :  (FD),  forms  definition  language  after 
compilation.  It  is  read  at  runtime  by  the  Form  Processor. 
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Forms  Def ini t i on  Language  :  (FDL).  the  language  in  which 
electronic  forms  are  defined. 

Form  Editor :  (FE),  subset  of  the  IISS  User  Interface  that 
is  used  to  create  definitions  of  forms.  The  FE  consists  of  the 
Forms  Driven  Form  Editor  and  the  Forms  Language  Compiler. 

Form  Hierarchy :  a  graphic  representation  of  the  way  in 
which  forms,  items  and  windows  are  related  to  their  parent  form. 

Forms  Language  Compi ler :  (FLAN),  subset  of  the  FE  that 
consists  of  a  batch  process  that  accepts  a  series  of  forms 
definition  language  statements  and  produces  form  definition 
files  as  output. 

Form  Processor :  (FP),  subset  of  the  IISS  User  Interface 
that  consists  of  a  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

Integrated  Information  Support  System:  (IISS),  a  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  data  bases  supported  by  heterogeneous  computers 
interconnected  via  a  Local  Area  Network. 

Item :  non-decomposable  area  of  a  form  in  which  hard-coded 
descriptive  text  may  be  placed  and  the  only  defined  areas  where 
user  data  may  be  input/output . 

Message :  descriptive  text  which  may  be  returned  in  the 
standard  message  line  on  the  terminal  screen.  They  are  used  to 
warn  of  errors  or  provide  other  user  information. 

Operating  System :  (OS),  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Page :  instance  of  forms  in  windows  that  are  created 
whenever  a  form  is  added  to  a  window. 

Paging  and  Scrol ling:  a  method  which  allows  a  form  to 
contain  more  data  than  can  be  displayed  with  provisions  for 
viewing  any  portion  of  the  data  buffer. 
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Qualif  ied  Name:  the  name  of  a  form,  item  or  window  preceded 
by  the  hierarchy  path  so  that  it  is  uniquely  identified. 

Subform :  a  form  that  is  used  within  another  form. 

User  Interface (UI),  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems:  the  Usei-  Interface 
Development  System  (UIDS)  and  the  User  Interface  Management 
System  ( UIMS) . 

User  Interface  Deve 1 opment  System :  (UIDS),  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

Window :  dynamic  area  of  a  terminal  screen  on  which 
predefined  forms  may  be  placed  at  run  time. 
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SECTION  2 

DEVELOPMENT  ACTIVITY 


2 . 1  Statement  of  Pretest  Activity 

During  system  development,  the  computer  programs  were 
tested  progressively.  Functionality  was  incrementally  tested 
and  as  bugs  were  discovered  by  this  testing,  the  software  was 
corrected . 

Several  existing  forms  which  had  been  created  using  the 
DIGITAL  EQUIPMENT  CORPORATION  utility  FMS  were  written  in  the 
forms  definition  language.  A  form  was  compiled  and  the  result 
was  displayed  and  visually  compared  with  the  existing  form. 

This  testing  was  conducted  by  the  individual  program  developer 
in  a  manual  mode.  Any  errors  were  noted  by  the  developer  and 
corrections  to  the  program  were  then  made  after  a  testing 
session . 

2 . 2  Pretest  Activity  Results 

Testing  of  the  forms  discovered  a  few  minor  bugs  which  were 
then  corrected  and  retesting  proved  successful.  Testing 
included  exceptional  conditions  and  error  conditions  for  the 
language.  The  overall  test  results  during  development  showed  no 
major  programming  errors.  Only  minor  bugs  were  discovered  and 
corrected . 


2-1 
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SECTION  5 

SYSTEM  DESCRIPTION 


3 . 1  System  Description 

FLAN  is  a  compiler  which  translates  Form  Definition 
Language  source  files  into  binary  Form  Definition  File  format. 
The  binary  Form  Definition  Files  are  then  used  as  input  by  the 
Form  Processor  (another  configuration  item  of  the  IISS  UI )  for 
display  and  entry  of  data  under  the  control  of  other 
application  programs. 

The  format  of  the  binary  Form  Definition  Files  produced  by 
FLAN  is  constrained  to  agree  with  the  format  expected  by  the 
Form  Processor  configuration  item. 

The  syntax  of  the  Form  Definition  Language  accepted  as 
input  is  described  in  the  Forms  Language  Compiler  Development 
Specification. 

The  interface  block  diagram  for  FLAN  is  shown  in  figure 
3-1.  The  top  box  represents  the  file  MYFORMS  which  is  input  to 
the  FLAN  compiler  (second  box).  FLAN  produces  a  Form  Definition 
object  file  (FD)  for  each  CREATE  FORM  statement  in  the  source 
file.  Each  FD  file  is  input  for  the  Form  Processor  which  is 
part  of  the  User  Interface  system.  The  compilation  of  an  FDL 
file  which  results  in  an  FD  file  is  the  same  as  program  language 
compilation.  The  FDL  file  is  the  source;  the  FD  file  is  the 
object . 
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MYFORMS  FDL 


*  CREATE  FORM  FI  •  •  •  . . 

i  Background  Black  >  •  process  * 

;  Prompt  ........... 

i  Center  at  2  40  1 

"Fori  FI 

'  I  tern  A  ♦ - * 

■  ii  data  i 

i  .  i  «. - + 

I 

CREATE  FORM  F. 

i 

i 


CREATE  FORM  F3 


I 


FLAN 


i 

+ - 4 - + 

I  I  I 

I  FI . FD  i  F2FD  i  F3.FD 


- 4 - 4  4 - + - +  4 - 4 - 4 

II  II  I 

- 4 - 4  •» - 4 - 4  4 - 4 - 4 

I  I 


4 -  - 4 


Form 

Processor 


+ 

i 

i 


•  REVFLAN 


l 

- 4 

FDL  i 

- 4 


*  *  MAKINC  * 

»  .  . 


i 

4 - 4 

i  variable  i 

i  declarations  I 

4 - 4 


Figure  3-1  FLAN  Interfaces 
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While  FLAN  is  normally  invoked  from  the  IISS  function 
screen  another  version  is  available  which  can  be  invoked  from 
the  host  system  This  second  version  is  required  so  current 
configuration  management  software  can  be  used  in  managing  FDL 
files  in  a  manner  similar  to  other  source  files. 

In  order  to  ease  the  conversion  of  forms  which  were  not 
created  using  the  Forms  Definition  Language,  REVFLAN  is  used. 
REVFLAN  is  a  program  used  to  create  an  FDL  source  file  from  one 
or  more  version  1  0  FD  files  which  were  created  using  the  DEC 
FMS  The  resulting  FDL  file  may  then  be  compiled  using  FLAN  to 
produce  version  0  FL  files  REVFLAN  is  invoked  from  the  host 
s y s  tern 

MAKINC  is  a  program  that  creates  program  variable 
declarations  which  correspond  to  the  structure  of  a  form  and  may 
be  used  in  application  programs  which  make  use  of  the  Form 
Processor  calls  PDATA  and  GDATA  The  following  programming 
languages  are  supported:  PL  I.  COBOL,  and  C  MAKINC  is  invoked 
from  the  host  system 

3  2  Testing  Schedule 

The  execution  of  FLAN  is  dependent  upon  the  NTM  subsystem 
of  IISS  and  testing  of  FLAN  must  be  done  only  after  the  NTM  has 
been  successfuly  tested  Within  the  UI  subsystem,  FLAN  uses  the 
Forms  Processor  and  must  be  tested  only  after  its  successful 
test 

3  3  First  Location  Testing 

These  tests  of  FLAN  require  the  following 

Equipment  Air  Force  VAX 

Support  Software  The  Integrated  Information  Support 

System,  the  ORACLE  database  management  system,  a  C 
compiler  and  the  UI  VTI  subsystem 

Personnel  One  integrator  familiar  with  the  IISS  FLAN 

Training  FLAN  training  and  manuals  have  been  previously 
provided  with  all  past  releases 

Deliverables  The  Forms  Language  Compiler  subsystem  of 

the  IISS  UI  VTI 
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Test  Materials:  This  test  is  interactive  and  can  be 

manually  performed  as  outlined  in  this  test  plan.  It 
also  could  be  run  as  a  script  file  if  so  desired.  No 
script  file  has  been  provided  because  it  is  believed 
that  on  first  testing  it  should  be  observed  and  then 
may  be  run  again  to  create  a  script  file  for  later 
testing  reruns . 

Security  considerations:  None. 

3 . 4  Subsequent  Location  Testing 

The  requirements  as  listed  above  need  to  be  met;  however, 
in  subsequent  testing  it  may  be  advantageous  to  create  a  script 
file  of  the  outlined  tests  and  run  this  saving  the  output  of  the 
test  for  future  comparisons. 

A  script  file,  FLANUTP.SCP  and  the  saved  output, 

FLANUTP . SAV  exist  under  IISS  Configuration  Management.  This 
script  may  be  generated  by  typing  RUN  VT100  and  at  the  args 
prompt  " -RFLANUTP . SCP  -SFLANUTP . SAV" .  To  compare  results  with 
those  obtained  by  during  successive  executions,  use  the  command 
file  Diffile.com  (found  under  Configuration  Management).  The 
only  differences  should  be  the  date  and  time  stamp  on  the  IISS 
function  screen. 
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SECTION  4 

SPECIFICATIONS  AND  EVALUATIONS 

4 . 1  Test  Specification 

The  following  requirements  are  demonstrated  by  the  out  1  i 
tests: 


Functional  Test  Activity 

Requirements  ABCDEFGH  I  J  K  I. 


Specification  of  forms: 
background  attributes 
form  prompts 
size 
f ields 

Specification  of  fields: 
type  of  field 
arrays 
location 
size 

display  attributes 
field  prompts 
domain  (item  only) 
help(message  and  form) 
value  ( i tem  only ) 

generate  form 

descript i ons 

semantic  error  messager 


A  -  input 
B  -  input 
C  -  input 
D  -  input 
E  -  input 
F  -  input 
G  -  input 
form  fatl 


of 

f  orms 

of 

f  orm 

of 

field 

of 

i  tem 

of 

all  f 

of 

all  i 

of 

i  terns 

fat  1  and  f at2 
tes  tf  orm . 

types:  items,  windows  and  forms, 
field  i4. 
ields  . 

terns  and  windows . 
il,  i5,  i6,  i7,  i8,  i9.  ilO,  10, 


window  wl 


nod 
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H 

input 

of 

i  terns 

l  5  . 

lb 

1  7 

l  npu  t 

of 

l  tern: 

l  9  . 

1  10 

j 

input 

of 

l  terns 

l  1  . 

1  2  . 

l  3 

K  form  descriptions  used  by  form  processor. 

L  input  of  file  FLAN2  FDL 

Th«  step;  outlined  in  Section  53  and  the  files  in 
appendices  A  and  B  show  the  direct  correspondence  between  the 
test  and  the  functional  requirements  as  listed  in  this  section. 

*i  .  T<  .  t  l  n£  Method:  and  Con:  traint: 

Tht  tests  as  outlined  in  Section  5  3  must  be  followed.  The 
required  input  is  stated  for  each  test  This  testing  tests  the 
no:  Did.  mode  of  operation  of  these  functions  and  does  not 
compiCtcly  exercise  all  the  error  combinations  that  a  user  of 
the  FliAN  might  create  by  faulty  entry  of  field  information 
These  tests  have  been  done,  however,  through  the  normal  testing 
done  by  the  developer  of  these  functions  No  data  recording  is 
required  No  additional  constraints  are  placed  on  this  unit 
test  besides  those  listed  in  Section  5  3  of  this  unit  test  plan 

4  3  Test  Progression 

The  progression  of  testing  of  the  FLAN  is  fully  outlined  in 
Section  5  3  of  this  unit  test  plan  This  progression  should  be 
followed  exactly  to  insure  the  successful  testing  of  this  IISS 
configuration  item 

4  4  Test  Evaluation 

There  are  several  :  tage:  in  the  testing  ol  FLAN 

Stagi.  1  Input  the  lil-  FLANi  FDL  TO  FLAN  This  will  produce 
the  FI  files  TESTFORM  IiOHELF  FAT  1  and  FAT.;  in  the  NTM 

due.  tur  y 

Stage  2  Run  SDARTESTZZ  from  the  IISS  function  screen  and  add 
the  form  TESTFORM  to  screen  This  will  produce  a  screen  like 
the  one  in  figure  5  ^ 

Stage  3  Input  the  file  FLAN2  FDL  to  FLAN  This,  will  produce 
the  error  messages  listed  in  section  533 
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SECTION  5 
TEST  PROCEDURES 


5 . 1  Test  Description 

A  general  description  of  this  unit  test  was  provided  in 
Section  3. 

5.2  Test  Control 


As  outlined,  this  unit  test  is  a  manual  test  which  may  be 
done  by  anyone.  The  required  input  data  are  documented  for  each 
function  being  tested  and  the  resulting  successful  output  is 
also  documented.  The  order  of  the  testing  is  also  completely 
documented.  The  test  control  information  is  completely 
described  in  Section  5.3.  Verification  of  the  test  is  by  a 
manual  comparison  of  the  test  output  with  the  expected  results 
as  they  are  documented  here. 

5.3  Test  Procedures 


To  run  the  unit  test  plan,  one  must  be  logged  on  to  an  IISS 
account.  The  NTM  must  be  up  and  running  and  the  UI  group 
logical  names  IISSFLIB.  IISSULIB  and  IISSMLIB  must  be  set 
properly  IISSFLIB  points  to  the  directory  containing  form 
definitions  ( . FD  files)  Therefore.  IISSULIB  should  point  to 
the  NTM  environment  directory  so  that  when  SDARTEST  is 
subsequently  executed  it  may  find  the  . f d  files  IISSMLIB 
points  to  the  directory  containing  error  messages  (MSG  files). 
The  FLAN  test  must  be  started  as  follows 

5  3  1  Access  to  IISS 

To  log  on  the  IISS  the  following  form  must  be  filled  in 


A 


5  1 
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USER  ID: 
PASSWORD : 
ROLE  : 


Msg:  0 


applcation i 

- + 


Figure  5-1  IISS  Logon  Screen 

(1)  USER  ID  is  the  identification  name  of  the  user,  and 
is  1  to  10  alpha-numeric  characters.  USER  ID  is 
input  as  "MORENC" . 

(2)  PASSWORD  must  be  the  password  associated  with  the 
USER  ID.  and  is  1  to  10  alpha-numeric  characters. 
PASSWORD  is  input  as  "STANLEY". 

i 3  i  ROLE  is  any  of  the  identifiers  which  are  associated 
with  the  USER  IL.  and  is  1  to  10  alpha-numeric 
characters  It  will  be  checked  against  functions  and 
applications  which  are  selected  by  the  user.  ROLE  is 
input  as  "MANAGER". 

When  this  form  is  correctly  completed  and  the  ENTER  key  is 
rsscd  the  form  in  figure  5-2  is  displayed 
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.3.2  Choosing  The  FLAN  Function 

Specific  IISS  functions  are  accessed  through  the  form 
isplayed  in  figure  5-2. 


*- - + 

l  IISS  TEST  BED  VERSION  2.0  I 

l  i 

► - + 

I  DATE. _ /_/_  TIME _  : _ : _  USER  ID: _  ROLE: _ I 

i  l 

'  FUNCTION:  DEVICE  TYPE:  DEVICE  NAME:  i 


Msg:  0 


applcation i 

- 4. 


Figure  5-2  IISS  Function  Screen 


When  the  form  appears,  the  cursor  is  located  in  the  FUNCTION 
field  The  items  in  the  form  are  summarized  below: 

(1)  DATE  contains  the  current  date.  This  may  not  be 
changed  by  the  user . 

(2)  TIME  contains  the  current  time.  This  may  not  be 
changed  by  the  user . 

(3)  USER  ID  is  the  user's  identification  that  was  entered 
in  the  previous  form.  This  may  not  be  changed  by  the 
user  . 
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(4)  ROLE  is  the  currently  active  role  and  was  entered  in 
the  previous  form.  This  may  be  changed  at  any  time. 

(5)  FUNCTION  is  the  function  the  user  desires  to 
act i vate . 

In  the  function  field  type  SDFLANZZZZ.  The  screen  in 
figure  5-3  is  displayed. 

•f - ■+ 

i  IISS  Forms  Definition  Language  Compiler  Release  2.0  i 


i  Forms  Defintion  Language  File  Name. 

! 

I 


Msg:  0 


applcat i on i 

- + 

Figure  5-3  FLAN  screen 


Type  in  "FLAN1.FDL"  (a  copy  of  FLAN1.FDL  must  be  in  your 
directory)  and  press  -enter-.  Wait  for  the  function  screen  to 
return.  Next  type  in  " SDARTESTZZ "  in  the  function. 
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Figure  5-5  FLANl . FDL/TESTFORM  Screen 


When  finished  viewing,  press  <quit>  and  when  the  function 
screen  is  displayed,  press  <quit>. 

5.3.3  Standalone  Version  of  FLAN 

The  standalone  version  of  FLAN  is  invoked  by  typing  “run 
[flandirlflansa.exe"  where  [flandir]  is  the  IISS  production 
directory  containing  the  FLAN  executable.  When  the  "args:" 
prompt  appears  type  " [f ormdir]f lan2 . fdl "  where  [formdir]  is  the 
directory  containing  the  FLAN2.FDL  file.  The  messages  printed 
should  be  identical  to  the  following  list. 

6:  ERROR  -  must  specify  relative  field  name  13:  ERROR 
-  size  not  specified  or  invalid 
18:  ERROR  -  value  too  big  for  field 
22:  ERROR  -  no  display  attribute  specified 
64:  ERROR  -  unterminated  string 
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66:  ERROR  -  value  too  big  for  field 

70:  WARNING  -  string  too  long 

72.  ERROR  -  duplicate  field  name:  J 

81:  ERROR  -  duplicate  display  attribute  specified 

86:  ERROR  -  unknown  display  attribute:  UGLY 

88:  ERROR  -  no  display  attribute  specified 

92:  ERROR  -  domain  only  legal  for  items 

98  ERROR  -  duplicate  justification  specified 

104:  ERROR  -  duplicate  case  specified 

110:  ERROR  -  duplicate  minimum  specified 

116:  ERROR  -  duplicate  maximum  specified 

122:  ERROR  -  help  only  legal  for  items 

122:  ERROR  -  field  NOTHING  referenced  in  item  BB  not  defined 
122:  ERROR  -  item  HH  off  left  of  screen 

122:  ERROR  -  item  G  off  top  of  screen 

122:  ERROR  -  form  TESTERR  prompt  off  top  of  screen 

122:  ERROR  -  form  TESTERR  prompt  off  left  of  screen 

122:  ERROR  -  circular  reference  in  location  of  item  DC 
122:  ERROR  -  circular  reference  in  location  of  item  CD 
122:  ERROR  -  overlap  between  item  A  and  item  CC 

122:  ERROR  -  overlap  between  item  A  and  item  E 

122:  ERROR  -  overlap  between  item  A  and  item  F 

122:  ERROR  -  overlap  between  item  E  and  item  F 

122:  WARNING  -  form  TESTERR  too  wide  for  standard  screen 
122:  WARNING  -  form  TESTERR  too  long  for  standard  screen 
122:  ERROR  -  form  TESTERR  too  narrow:  fields  extend  to 
column  157 

122:  ERROR  -  form  TESTERR  too  short:  fields  extend  to  row  25 

130:  ERROR  -  duplicate  help  specified  136:  WARNING  -  help 

message  too  long,  truncated 
142:  ERROR  -  value  only  legal  for  items 
156:  ERROR  -  unknown  function  FUNC 
162:  ERROR  -  invalid  argument  for  INDEX 
168:  ERROR  -  duplicate  size  specified 

173:  ERROR  -  unterminated  comment  Unable  to  continue... 


5-7 
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APPENDIX  A 
FLAN1 . FDL 


FLAN  input  file  with  correct  syntax  and  semantics  to  test  all 
features . 

/’  test  forms  for  the  flan  compiler  */ 
create  form  testform 

prompt  center  at  2  below  i3  and  column  6  "array"  /*  form 
prompt  *  / 

item  il 

size  1  at  2  3 
display  as  input 
value  "1" 

prompt  at  1  2  "size/display" 

item  i2 

size  2  by  2 
at  below  i 1 
display  as  output 
value  "2222" 

item  i3 

size  3  by  2 
at  below  i2 
display  as  text 
value  "333333" 

item  i4  (2  v,  3h2,  2v2)  /*  array  */ 

at  3  below  i3  and  column  2 
size  1 

display  as  input 

form  fatl  /*  forms  */ 

at  3  below  i3  and  column  12 
size  6 

prompt  at  above  "forms" 

form  fat2 

at  below  fatl 
size  6 


/*  item  field  */ 

/*  field  size  */ 

/*  field  display  attribute  */ 
/*  item  value  */ 

/*  field  prompt  */ 


A-  1 
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window  wl  /*  windows  */ 

at  3  right  of  fatl 
size  5 

background  white 
prompt  at  above  "windows" 

window  w2 

at  below  wl 
size  5 

background  black 

item  i5 
at  2  15 
size  2 

display  as  input 
domain  (must  enter  must  fill 
prompt  at  right  "(must  enter 
prompt  at  1  above  and  col  15 

item  i6 
at  below  i5 
size  4 

display  as  input 
domain  (left  lower) 
prompt  at  right  "(left  lower)" 

item  i7 

at  below  i6 
size  4 

display  as  input 
domain  (right  upper) 
prompt  at  right  "(right  upper)" 

item  i8 

at  below  i7 
size  4 

display  as  input 
domain  (max  10  min  0) 
prompt  at  right  "(max  10  min  0) 


/ *  domains  * / 


numeric) 

must  fill  numeric) 
"domains " 
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item  i9  /♦  help  */ 

at  2  60 
size  1 

display  as  input 
help  "help  message  for  i9" 
prompt  at  right  “message" 
prompt  at  1  above  "help" 

item  ilO 

at  below  i9 
size  1 

display  as  input 

help  ilOhelp 

prompt  at  right  "form" 

item  10  /*  location  tests  •/ 

at  13  40 
size  5  by  5 
display  as  input 
prompt  at  4  above  "location" 

item  11 

size  2  by  2 
display  as  input 

bottom  right  at  1  above  10  and  2  left  of  10 
value  "1111“ 

item  12 

size  2  by  2 
display  as  input 

bottom  left  at  2  above  top  left  of  10 
value  "1212" 

item  13 

size  2  by  2 
display  as  input 

bottom  right  at  above  top  right  of  10 
value"1313" 

item  14 

size  2  by  2 
display  as  input 

bottom  left  at  1  above  10  and  2  right  of  10 
value" 1414" 


size  2  by  2 

d 1 sp 1  ay  as  l nput 

top  right  at  left  of  top  left  of  10 
va 1 ue ” 1 5 1 5 " 

l  teni  16 

size  2  by  2 

display  as  input 

bottom  right  at  2  left  of  bottom  left  of  10 
va  1  u*  "  1616" 

item  IV 

size  2  by  2 
d i sp 1  ay  as  l nput 

top  right  at  1  below  10  and  2  left  of  10 
va 1 ue " 1 7 1 7 " 

item  18 

size  2  by  2 
display  as  input 

top  left  at  below  bottom  left  of  10 
value"  18  18'' 

item  19 

size  2  by  2 
display  as  input 

top  right  at  2  below  bottom  right  of  10 
value" 1919" 

l  tern  1  a 

:  i:.r  2  by  2. 
display  a:  l npu t 

tip  left  at  1  below  10  and  ..  right  of  10 
va 1 ue "  1  a  1  a " 

item  lb 

size  2  by  2 
displav  as  input 

top  left  at  2  right  of  top  right  of  10 
value" 1 bl b" 
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item  1 1 

r  1 zt  2  by  ... 
display  at.  input 

bottom  left  at  right  of  hot  tom  right  of  lo 
va 1 ue  1  c  1  *. 

create  form  llOhelp 
size  80  by  20 

prompt  center  at  10  40  help  form  form  item  110 

reatf  form  fat]  •  form  background  and  :  l k 

ba  kg  I  uund  wl. .  t  < 
s  i  zt  ^ 

promp  t  .it  i  .  fall 

create  form  fat 2 
background  black 
size  5 

prompt  at  1  2  "fat2‘ 


a  t. 
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APPENDIX  B 
FLAN2 . FDL 

FLAN  input  file  to  test  all  semantic  error  messages. 

’  flan  forms  to  force  all  semantic  error  messages  */ 
create  form  testerr 

size  1  '("form  %s  too  narrow:  fields  extend  to  column  %d" , 
("form  %s  too  short:  fields  extend  to  row  %d“ ,  */ 
prompt  at  left  "testerr"  /‘("must  specify  relative  field 
n.unt  1 

pi ompt  at  25  2  off  bottom" 

item  a  ’(size  not  specified  or  invalid");*/ 

t  1  2 

l sp lay  as  l nput 

item  b  '( ‘value  too  big  for  field");*/ 
size  1 
value  "22" 
display  as  input 

item  cc  ’('no  display  attribute  specified");*/ 
size  1 
at  1  4 

item  bb  •( "field  %s  referenced  in  %s  %s%s  not  defined".*/ 
at  below  nothing 
size  1 

d ; s p 1  ay  a:  input 

item  cd  '  circular  reference  in  location  of  %s  ts"»s '  ,  * 
at  be  1 ow  d 
size  1 

display  ar  input 

i tern  dc 
at  above  cd 
size  1 

display  as  input 

item  e  '("overlap  between  %s  \sts  and  5»s  \s\s "  .  * 
at  2  2 
size  1 

d l sp 1  ay  as  l nput 


B  1 
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i  tern  f 
at  2  2 
size  1 

display  as  input 

item  g  / * ( "%s  %s%s  off  top  of  screen".*/ 
at  -1  10 
size  1 

display  as  input 

item  hh  / * ( "%s  %s%s  off  left  of  screen".  */ 
at  1  - 1 
size  1 

display  as  input 

item  i  /*( "unterminated  string");*/ 
at  1  6 
size  1 

display  as  input 
value  "hello 

item  j  /‘("string  too  long");*/ 
at  1  8 
size  150 

display  as  input 
value 

" 1234567891 1 234567892 1 234567893 1234567894 1 234567895 1 23456789612 
345  67897123 

4  567898 1234567899 1 234567890 1234567891 1234567892 1 234567893 123456 
7894 " 

item  j  '("duplicate  field  name  %s".  * 

a  t  3 
size  1 

display  as  l nput 

item  k  ’("duplicate  display  attribute  specified"),* 
at  3  4 
size  1 

display  as  input 
display  as  input 

item  1  ’('unknown  display  attribute  ‘Vs".  • 

at  3  6 

5.  1  7.C  1 

display  as  ugly 
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window  m  at  3  8 
size  1 

display  as  black 

domain  (upper)  •("domain  only  legal  for  items").* 

item  n  ‘("duplicate  justification  specified").* 
at  3  10 
size  1 

display  as  input 
domain  (left  right) 

l tern  o  '('duplicate  case  spec i f i ed ' ) .  * 
at  3  12 
size  1 

display  as  input 
domain  (upper  lower) 

item  p  /‘("duplicate  minimum  specified");*/ 
at  3  14 
size  1 

display  as  input 
domain  (min  10  min  2) 

item  q  /‘("duplicate  maximum  specified");*/ 
at  3  16 
size  1 

display  as  input 
domain  (max  10  max  2) 

w i ndow  rr  / * ( “ he lp  only  legal  for  i terns " ) ;  * 

at  3  18 
size  1 

display  as  black 
help  "hello1 

create  form  testform 

item  s  / * ( "dupl i cate  help  specified");* 
at  3  20 
size  1 

display  as  input 
help  "hello" 
help  “hello" 
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item  t  'help  message  Loo  long,  truncated");* 

at  3  2. 
siz<  1 

display  as  input 
he  1  p 

" 1 234567891 1234567892123456709312345678941234567895123456789612 

34567097 

window  u  M  "value  only  legal  for  l terns "  )  ; * 

at  3  24 

i 

l  .  .  (  .  :  ’  .1  h  4 .  t  k 

V  a  1  U  *  hill  <■ 

i.  :  *,  >  t  *  f  u  r  ir  testforn 

;  U'lr  vv  *i  duplicate  value  specified"),* 
at  3  2k 
size  10 

display  as  l nput 
va 1 ue  "hello" 
value  hello" 

item  w  ‘(unknown  function  %£ “ .  * 

at  3  30 
s  i  ze  20 

display  as  i nput 
value  fund  hello  ) 

item  x  ‘("invalid  argument  for  INDEX");*' 

at  3  60 

;  :  ze  2f 

1  .  f  .  a v  ,i .  input 
v  i  .  i » •  ,ri1(  x  1  i 


.  t  *  r  •  ‘  dup  1  i  <■  at  r  «.  i  ze  spec  l  f  l  ed  "  )  ,  * 

cl  •*  . 

S  i  Zt  1 

size  1 

ditplav  a:  input 


create  form  endless 

*  else  if  (c  ■=  =  EOF)  {  fat  a  1  ("  unterm  l  nated  comment");  return 


